# Spotler integration (REST API)
# Requirements
- Rest API Key + Secret from Spotler
- ContactManager version 25.1 or newer
- Maiplus version 24.3.0.9358 or newer
- The Mailplus plug-in needs to be placed in the Web/Bin ContactManager directory
# Configuration
If plug-in is installed enter the API Key + Secret in the Mailplus configuration Tab and press on save
After saving, the fields available in Spotler are shown.
- Internal Name = Is the internal name of the field in Spotler
- Description = Display name of the field in Spotler
- ContactManager = Internal ContactManager field
if no ContactManager value is shown then the field is not yet mapped.
Mapping file is in directory: \Web\Config Filename: MailPlusMapping.ini
- if there is no file, rename the "master" file (MailPlusMapping.master.ini to MailPlusMapping.ini ) ALERT!!! if you update the mapping in the Master file, the changes are overwritten in the NEXT update
# Settings
# Mailplus configuration Tab
- Synchronise:
Starts the Daily Synchronise Job. Checks all modified contacts in Spotler and Updates the linked subscription folders since last time. The Job also runs everyday during the DailyRuntimService
- Reset Permissions
USE WITH CARE this will remove all permissions on contacts in ContactManager and imports all permissions from Spotler. Spotler is Leading!
- Import mailing statistics
<>
# CRM Configuration Mailplus settings
- AutomaticSyncToCM
Fields on a contact in ContactManager that are automatic overwritten when a new value is detected in Spotler during the daily synchronise job. Other fields needs to manually reviewed in the "review updates" Tab
- AllowChangeNewsletterRole
Specify the name of the role that can modify the newsletter subscription (change permissions on the contact are also required)
- SubscriptionItemStatusCodeForSignIn
Enter the code from the SubscriptionItem Status list(Lookup Items list ) that will be used as the "Attend" Status. This code needs to correspond with the question in the Spotler form. See functional documentation in the "doc" directory ()"Koppeling ContactManager en Spotler-MailPlus"
- SubscriptionItemStatusCodeForSignOut
Enter the code from the SubscriptionItem Status list(Lookup Items list ) that will be used as the "Not Attend" Status. This code needs to correspond with the question in the Spotler form. See functional documentation in the "doc" directory ()"Koppeling ContactManager en Spotler-MailPlus"
- ProfileEmailFieldName
Enter the Spotler internal field name for the Email field. Can be found in the Mailplus configuration Tab
- EmailAddressAlerts
Enter the e-mailadress for the alert and notifications. If Empty the datasteward emailaddress is used (General settings)
- SyncPermissionsToSubscriptionStatusPermissions
When using the Spotler REST Api this value should always be "True". When on "True" the LookUpList "SubscriptionStatusPermission" is used for the Permissions. (SOAP API used a different list)
- Debug
When on "True" extra logging is generated
- Disabled
When on "True" the integration is disabled